ADDENDUN 


Several new features are contained in the 12/20/82 release of 
your XOR CP/H, 


1.) DIAGNOSE.COM is I an automatic,NON-DESTRUCTIVE system test 

utility that will test system memory and both drives, It should 
be run before drive "B:" has been accessed. The tests take about 
S minutes to run and assure everything is in good shape to - run 
your software, Data is output to system printer so you need not 
and watch the screen, (Got to keep up with IBM you know!) 


2.) BACKUP,.COH will help first time users make that initial 
important backup of their CP/M source disks. BACKUP should be the 
FIRST program that you run after receiving your computer, The 
SOURCE disk goes in drive "A" and a GLANK destination disk in 
drive "B", BACKUP will format the destination disk and copy A to 
B,. (In all XOR systems drive "A" is on the Left and drive "B" jis 


on the right.) 


3.) HELP.COM will aid first users of CP/M, BASIC, and many other 
run time programs, Simply type HELP CPM <CR> or HELP HBASIC or 
whatever ???,HLP program Libraries appear on your current 
distribution disks, To See what they might be, type. D *,HLP <CR>., 


4.) SURVEY.COM will look over all i.o. ports and report what is 
being used, Interesting to use when you want to add something 
else to the system and want to avoid clashes. (why not ?) 


5.) MDISK is now with us, - WHAT IL .IDISK you ask ? 

It is a kind of cache memory system that is CP/M oriented, It 
takes the place of the "D" drive and is as Large as your pocket 
book, For all intents and purposes it is a disk drive, Only it 
stores it's data in RAM. It can be expanded in 48K increments to 
about SOOK. If you do a lot of assembler or compiler work and can 
think of several hundred better things to do than sit waiting for 
the processor to complete it's task, this may be useful to you, 


Typical performance increases over our floppy times will be in 
excess of 100 per cent, (That means you will only have to. sit 
half as long. ) Those of you who are familiar with our system 
will realize that as we are already the fastest around, this is 
some real improvment. Comparing it to an Apple or an Orange is a 
joke, > 


MDISK will assemble a 20K assembly source program producing a 3OK 
20K MACRO LIB files in 21 seconds ! OQur Apple took 3 1/2 minutes 
and our Plastic Shack 2 min and 14 secs to do Similar tasks, 
Unfortunatly the Orange was in peels by the time we got to it’ So 
no testing could be done, | 


Loading a tlarge .COM file Like MBASIC (28k) takes .68 sec. 
Actually hard to measure, I'ts fun inpressing your friends’ with 
1 


6.) Maybe this is not a feature but it does have to be mentioned. 
If your drives are made by TANDON, (a slimline with closing 
Lever at the upper right) the disks are to be inserted with the 
Label (top) to the RIGHT. This is different than the other todels 
used in XOR systems in the past, 


7.) The disk drivers for 48 and S6 tpi, single and double’ sided 
mini 5" drives have been turned on in the distribution version 
of the CP/H "A" and "B" disks, le strongly reconnmend (in fact 
insist?) that you use the 512 byte per sector mode for all _ the 
mini types, To run minis with 8" drives, Simply plug in the 
drives and run DFOCO to format the minis. The command Line to 
correctly format a 96 tpi double sided drive in DFOCO would be; 


* DFORMAT C: SIZE 572 MINIS6 DBL <CR> 


Vie are assuming drives "A" and "B" are &" and drives "C" and "D" 
are strapped as minis, 


After formatting and PIPing data to the mini, the operating 
System may be transferred to the mini useing DSYSGE!N, See the 
manual for specifics on using DSYSGEN. Transfer method #3 where 
you answer <CR>, <CR> to the first two questions and then take 
the OS directly from the 8" floppy and put it on the mini would 
be the easiest to do. After successfully accomplishing the above 
two feats, re-strapping the floppy controller so that the minis 
are "A" and "B" will allow you to boot from them after a reset. 


Sone problems have been noticed booting mini floppies by 
certain manufacturers, It will work but sometime not always -~ an 
the first try. It is caused by a drive ready signal not being 
available as is on 8" systems, A new version of the boot pron, 
(vers 1.85) is corrects this problem, 
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- 8.) A parallel printer driver has been installed in the bios 
STDLST.ASH, This driver can be used for Centronics’ type cable 
interfaces, (See the appendix for parallel cable wiring.) Three 
methoaqs may be used to "turn on" this driver, As shipped the 
bios drives the serial port "A" on the CPU with alt CP/M List 
.outputs. To switch all output to the parallel port on a temporary 
basis you can set a byte in memory at EESSH to a QSH, This can 

be done with UDT ofr BASIC with "POKE” instrection, This memory 
can be calculated for different system sizes by picking up the 
the bios jump table and can be calculated for different system 
sizes by picking up the warm boot entry address at memory 
Location 1 and 2, and adding SOH to that address, (30H = 48 
decimal) | 


A second methad, which is permanent for the disk that the change 
was made on and all copies of that disk is to use the system 
utility DDUMP.COM to modify the byte on the system tracks of the 
floppy. You wilt find the bios jump table on track 1 Sector 20. 


DDUMNP <CR> (OPERATOR INPUT) 
= (PROGRAM RESPONSE) 
+ 4 8 20 E0iT <CR> (OPERATOR INPUT) 
~~ ELT _ (PROGRAM RESPONSE) 
33 <CR> (OPERATOR INPUT) 
0033 QO (PROGRAM RESPONSE) 
05 <CR> (QPERATOR INPUT) 
om 0037 0OQ0 (PROGRAM RESPONSE) SET TO 01 FOR GMS SEEK 
WRITE <CR (OPERATOR INPUT) WRITES YOUR EDIT TO DISK 
“C | (OPERATOR INPUT) RETURNS TO CP/H 
“C 


A third method is to uSe a text editor to modify the bios’ source 
code module I10,ASM which contains the bios jump table. You will 
need the Digital Research MAC assembler to do this. It may 0Obe 
purchased from your closest U S MICRO SALES OFFICE, 


Obviously if you should want to switch back to serial output, the 
Same byte should be set to a "Q", | 


Note that another complex printer driver option has been supplied 
in the form of CXLST.ASM and its associated PRINTER,COHM, CXLST 
may require modification to get your printer to work properly, In 
the command submit file BLKSYS61,SUB, several modules are 
concatenated by PIP.COM to assemble the system bios. If you 
plan on changing anything, just tackle the module you need and 
Generate a whole new bios by doing another submit, The 
distribution version also contains a simple driver called 
STDLST.ASM, You may want to replace CXLST.ASH with STDLST.ASN 
and re-assembe the bios, Up to six printer drivers can be 
resident in the bios at one time useing CXLST. 


= PRINTER.COM will select the printers by simply typing PRINTER 3 
| (for example). PRINTER,.COM can also change the baud rate that is 
supplied to the respective printer, 


mm 


PRINTER.COM has a "TEST" mode (invoked by typeing ‘PRINTER T 
<CR>') which will poll the selected printer: port's status port 
and. display the control bits on the sereen, BEFOHE you try to 
Send data to your printer, run PRIUTER.COH in the test mode to 
see if the status bits are set correctly. This will Save an 
enormous ammount of time in getting things to run, 


PRINTER,COH also will send either single characters or a 
continuous string so that system handshaking can be tested, 


Custom PRINTER.COM type programs can De written and renamed 
DIACLO,COM or HX8O,COMN or TIe210.COM (for example). These can be 
very simple programs that merely modify one or two cells in 
system memory. The memory cell 30h bytes past the warn boot 
entry in the jump table is where the currently Logged printer is 
kept. Bytes at 31H,32H and 33H offset from warm boot are the baud 
rate bytes for the cpu brg, serial board 1 and 2 respectivly. The 
system can handle 10 serial ports and 1 Centronics type port with 
parts available from your USM SALES OFFICE, AO at offset SOH from 


warm boot will select channel "A" serial port on the cpu, This 
is. printer ¢ 0, CXLST always initializes to this’) printer, 
Printers 1,2,3 and 4 are expected to be on an optional serial 
expansion board that is available from your U.S, HICRO SALES 
OFFICE. ‘ Printer 5 is expected to be the parallel port aon 
the CPU, An exanple of a program that would select printer 


number 3 and set the baud rate to 1200 baud is as follows: 


ORG 100H 
SrA 
NVI A,OS3H >; printer select 
LHLD 1 >; get warm boot address 
LAL 0,308 ; Or sest 
DAD OD : 
MOV A,M ; set printer 


The baud rate port on the CPU is at 1.0. port location OBH. A 
slight complication arises in that you probably would not wish to 
change the baud that the system terminal is running at, In this 
case you would have to read the CPU baud rate switch and ORI the 
upper 4 data bits on to your new Lower 4 bits before re- 
programming the brg. Look at how things are done in PRINTER.ASH 
as an example if you have any problems, 


ats 

Another common problem we get calls on bears mentioning, It -is 
explained in the General Operating proceedures section of your 
manual how to put the operating system from one diskette to 
another, but for some reason many customers don't understand this 
procedure, If you want to transfer the operating system from 
one disk to another, simply Load DSYSGEWN and answer (NJ) and (NHN) 
to the first two questions that come on the screen, A table will 
then appear with a sub-Line asking "CODE BYTES FOR SOURCE DISK?", 
Usually you will need to enter 1A, which signifies 512 byte 


Single sided. The other common code byte is SA, which is for 512 
byte sectors, but double sided, After determining the type of 
source disk and drive name, hit a <CR> to "CONTINUE", The next 
question asked will be for the code byte for the destination 
disk, After telling dsysgen the type and drive, it will do the 
transfer, It's really very simply and should take no more than 15 
seconds to do. If you find yourself well into the first hour, 
READ THE MANUAL. There is a step by step example in there. Don't 
forget that the destination disk must have a suitable format’ on 
it. If your not sure on this point, use DFOCO to format the disk, 
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you are copying a system on a single sided diskette, to a 
Le sided diskette, OSYSGEN will tell you "the source = and 
ination formats do not agree, do you wish to continue?", Y ou 
type yes and the transfer will be conplete, 

her item to be noted, all XOR systems are compatible with 


dard 128 single density, however there iS not enough room on 


System tracks of the disk to place the’ system, You must 
up on a Double density diskette in "A" drive, Single 
ity files then may be transferred from "8" to "A" with PIP. 


INFO 


Port assignments: 


The 
of 


might be a 


( Th 


This 


00 Channel "A" status (See status flag below) 

01 Channel "A" data 

02 Channel "B" status (See status flag below) 

03 Channel "B" data 

04 Parallel "A" data 

05 Parallel "B" data 

O06 Parallel "C" data 

07 Parallel command port 

08 Memory management 

0Q9 Prom Toggle, QO = on 01 = off 

OA Boot prom disable 

OB Read/ Baud rate switch Write/ Baud rate generator 

OC CTC chan 1 

OD CTC chan 2 

OE CTC chan 383 

OF CTC CHD 

8251 can be programmed under software control to do a number 
things. The following code can be used to initialize what 


"normal" mode for the 8251, 


e chip must be initialized or it will do nothing, ) 
MVI A,QAAH ; Load A 
OUT QO3 ; LHP tisaiize Pert 6 
OUT 04 . Initialize Port A 
MVI A,40QH ; Load A 
OUT O83 >; With Internal Reset 
OUT O01 -* Write to Both Ports 
MVI A,4EH : TY Btoyp bitsy 10 parity, 8 date bits 
OUT -* [6X clock 
OUT QO3 : 
MVI A,37H ; RTS = 1, reset errors, enable Rx, 
OuT 04 ; DTR = 1, Tx enabled 
OUT O93 : 


initialization will set up @ data bits, one stop bit and no 


parity. Your printers and terminals have to be set up to receive 
the same pattern, 


8251 Status Flags (when you input status port, this is what byte 
will mean): 


DSR SY FE QF PE TAGE BAR TAR <-Output bit LADY when Hi} 


| -------- Input bit (ROY when Hi) 


Parts for the Serial I0 are: A Status = 1 A. Data = 0 ton Left) 
B Status = 3 B Data = e2 fon right) 


The 8 position DIP switch at the Lower right hand corner of the 
board is broken into two 4 bit sections, The upper 4 bits select 
the IQ baud for the Left 8251 and the lower 4 bits select the 
baud for the right, Vie connect the Left 8251 to the "A" paddle 
card and the right one to the "6" paddle card, The paddle cards 
are mounted to the rear panel and make strapping adjustments 
easier, The "A" port is committed in the CP/M bios software to 
Lhe printer, and the “B" port to the CRT Terminal. 


The switches are used in a binary pattern to set the rates as 
follows: 


DIP 
Switch 
OFF ON 
RAPT E.  Seerett 
B [li Pore A lett) [Printer] 
CFLS | Set for 
D | Li} 300° BAUD 
i ce we I a in as ei ee ei ie na em 
ae C)}! Serial 
Bo itd | Port B (Right) [Terminal] 
C It] | Set for 
DIC] | 9600 BAUD 
ire eee ees 
A = OQ F fF 0 = OQO4N 
Baud uu & «8B A Caud Uv G&G “BA 
sii i [pn on ah os cern ee wi set ewe | cea er oe cat 
90 PO 3 oO .. 2 BAY 1200 Ee. Oe mR. ae ay 3 
79 Poe oO ae ER 1800 is  O@ DO & .4°OBH I 
4410 ro 2 eR 2-2 gern } 2000 (xe & OF A 0 OSH J 
t94ec0. 5:6 O- % 2 cf Ban 3 2400 ix OO XxX © f, CAR GQ 
150 fA ob -f Ban 3 3606 Lx © *& xX { QBH ) 
300 CoO ®& de & -4 Se 4800 {xX xX @ 0 { OCH } 
600 iO - x* 8  £ O6H 3 7200 Eom Ao oe. oe BH 2 
| 39600 | xm RM Ro O- £ BEA 3 
| 19200 ae, Ge > ae a hs ss ee 
a Ee 
fake sure when using the above chart that the positions we show 
correspond to the type of switch you have on the _ board, Some 
earlier models of switches have the "ON" to the opposite side, 


4 Port serial Port assignments 


LOW SERIAL PORTS 


20 CHANNEL A DATA 

a1—=C«" A STATUS 

ge 8 B DATA 

23 2=C«#s B STATUS 

24 0 C DATA 

25 C STATUS 

26 =i D DATA 

a D STATUS 

3A BAUD RATE SELECT 

HIGH SERIAL PORTS 

AOC A DATA 

A," A STATUS 

Ag" B DATA 

AR" B STATUS 

A4 C DATA 

A5 " 5 STATUS 

AG" D DATA 

Ay oo" D STATUS 

AA BAUD RATE SELECT 
PMMI MODEM BASE ADDRESS = CQO 


SOME TIPS ON HOOKING UP PRINTERS 


Almost all serial printers use four basic Lines, Our computers 
"Look" Like modems in terms of RS-232 specifications, That is 
because originally terminals attached themselves to modems that 
in turn talked over phone Lines to mainfranes, When cheap Nicro- 
viefputers came on the scene it was Logical to make them plug 
directly into the terminals, | 

The minimum Lines needed to maintain communication are Transmit, 
Receive, Logic Ground, and Frame Ground. These are on a DB-25 
connector on pins 93,2,/7 and 1 respectively. 

These terms only hold true if you are a modem, DB-25 connector 
pin assignments should always be referred to as if the moden was 
the subject. Therefore if pin 3 is "Transmit", if you are 4a 
terminal, you should receive on pin ¢@, 

There are other signals on a D8S-25 RS-232 serial connector that 
are standard. These signals were originally intended for tmoden 
use and their names reflect these intentions, They are; CTS 


(Clear to send), ATS (Request to send), DSR (Data set ready), 
DTR (Data terminal ready), 

These "secondary signals" as they are called are used to inforn 
the terminal user when the computer and transmission equipment 
can send data, 

When attaching a printer, we use the principal signals to convey 
data in both directions and the secondary signals to "handshake", 
To handshake means to inform each other when you are prepared to 
communicate, It's rather Like picking up the phone after hearing 
it ring and saying "Hello", Then the other person identifies 
himself, and so on. Humans "handshake" in many ways that are not 
readily apparent, Facing someone and nodding your head to-start a 
conversation is "handshaking", 

On our Paddle cards at the back of the computer are places for 
two resistors, They are called "pull up" resistors and must’ be 
installed if the serial port handshaking Lines DSR and CTS are 
not to be used, These resistors can be anything from 1K to 10K, 
If buffer full hancshaking is to be used, the correct Line must 
be located which indicates that status on the printer you are 
using, The resistor "pulling up" the status Line you wish to use 
must be removed feither can be used), and a jumper soldered 
between the RS-232 Line and place where the resistor was. The 
other available handshaking Line can be used for Of! LINE/ OFF 
LINE status or ??, But for any transmission to take place both 
serial units must be at the same baud rate and both handshake 
Lines must be acive (high). 


NOTE: Pin 20, DTR ----- ~*~ | Nill not work an 8251,. wse CTS, pin 5 
TM a he yn Beg oa a te ts 
DB-25 a oe ar ae ae a ee oe oe a ee - As a HODE!H appears - 
Ppp ae oe be a RE a OR, RE ee ON ( and your computer ) 
~------------------------+- 13 
+ 2 2 4 8:6 7 
Pr TRG PG S DATA BIIS, 7 STOP,. HO PARLTY 
HAA T TS WN 
HM os 5S A D 
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This cable 


uses a 8255, 


NOTE: 


This 


PARALLEL CABLE WIRING 


1s used 


for 


Centronics 


interface printers: is 


PAO-7 are used for data transfer, PuG=-/ are tied 
together for data strobe PC6 for ACK 


Cable is 


SALES OFFICE, 


CPU CABLE 


(1) 
(23 
(3 ) 
(4) 
(5) 
(6) 
(7) 
(8) 


ci Ol Fo © 


ADO 
AD 1 
AD2 
AD3 
AD4 
AD5 
ADG 
AD7 


(9-16) BD0-7 


CD4 


CDS 


available 


from printer, 


From your U § WNICRO SALES 
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CPU 8255 connector pinout Looking from front with edge connector 
at bottom, 
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